home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 4 / Gold Medal Software - Volume 4 (Gold Medal) (1994).iso / utils1 / dmav12.arj / DM.DOC < prev    next >
Text File  |  1994-07-28  |  11KB  |  247 lines
  1.                               Directory Maven
  2.                                 Version 1.2
  3.  
  4.                       Copyright (C) 1994 Kent Briggs
  5.                             All Rights Reserved
  6.  
  7.  
  8.      Purpose
  9.      -------
  10.      maven (MAY vin) n. expert or connoisseur, devotee.
  11.  
  12.      Directory Maven is DOS utility program that allows the user to
  13.      quickly change to another directory across any drive (quick mode
  14.      option) or to view the directory structure of all drives in a
  15.      graphical tree format (tree mode option).
  16.  
  17.      License
  18.      -------
  19.      Directory Maven is Freeware, i.e. copyrighted software that may be
  20.      freely distributed and used indefinitely without payment to the
  21.      author.  The only restrictions that apply are that the program
  22.      files must be distributed together and unmodified, including the
  23.      documentation files.  This software is provided as is and without
  24.      warranty.  The author assumes no liability for damages, either
  25.      direct or consequential, which may result from the use of this
  26.      product.
  27.  
  28.      Installation
  29.      ------------
  30.      Copy DM.EXE into one of your path directories so that it can be
  31.      executed from any directory.  Type PATH at the DOS command line to
  32.      see a list of your path directories, each separated by a ";".
  33.      Edit your AUTOEXEC.BAT file to modify your PATH.
  34.  
  35.      DMCONFIG
  36.      --------
  37.      If you have a monochrome monitor, you may need to run DMCONFIG.EXE
  38.      to change the screen colors from the default color setting to
  39.      black and white colors only.  DMCONFIG will modify DM.EXE with
  40.      the new color settings.
  41.  
  42.      Scan File
  43.      ---------
  44.      Directory Maven scans the directories on your drives and stores
  45.      this list in a file called DM.DAT.  By default, DM.DAT will be
  46.      stored in the same directory as DM.EXE.  However, this will cause
  47.      problems if DM.EXE is on a network drive and being shared by many
  48.      users.  Therefore, Directory Maven will first look for a DOS
  49.      environment variable called DIRMAVEN that points to the location of
  50.      DM.DAT.  Use the SET command in your AUTOEXEC.BAT file to define an
  51.      environment variable (e.g. SET DIRMAVEN=C:\GLOBAL).  If this
  52.      variable does not exist then Directory Maven looks for a one-line
  53.      ASCII text file called DM.CFG in the same directory as DM.EXE.
  54.      DM.CFG will specify the location of DM.DAT.  To create a DM.CFG
  55.      file that specifies C:\ as the DM.DAT directory, type the following
  56.      lines at the DOS command line:
  57.  
  58.      COPY CON DM.CFG <Enter>
  59.      C:\ <Enter>
  60.      <Ctrl-Z> <Enter>
  61.  
  62.      Finally, if DM.CFG does not exist, then Directory Maven stores
  63.      DM.DAT in the same directory as DM.EXE.
  64.  
  65.      First Time Operation
  66.      --------------------
  67.      Start Directory Maven by typing DM at the DOS command line and
  68.      press Enter.  Press F2.  Type in the letters representing the
  69.      drives you want scanned.  Your active drives are shown in black in
  70.      the upper left corner of the screen.  Normally, you would not scan
  71.      removable media drives such as floppy or CD-ROM drives, although
  72.      you can if you want to.  Press Enter to scan the drives and create
  73.      the DM.DAT scan file.  After scanning, press Esc or Alt-X to exit
  74.      Directory Maven.
  75.  
  76.      Quick Mode Operation
  77.      --------------------
  78.      Use the command line options to operate Directory Maven in
  79.      Quick Mode.  Type DM ? to see all the possible parameters.  The
  80.      parameters are not case sensitive.
  81.  
  82.      To quickly change to another directory (even if it is on another
  83.      drive) enter one of the following commands at the DOS prompt:
  84.  
  85.      DM partial_directory_name
  86.      DM *partial_directory_name
  87.  
  88.      where partial_directory_name could be something like "my" when
  89.      you want to change to a directory that starts with "my" such as
  90.      "C:\LOTUS\MYFILES".  Precede the name with an "*" to find matches
  91.      within the directory name.  For example, "DM file" would not find
  92.      "C:\LOTUS\MYFILES" but "DM *file" would.
  93.  
  94.      Directory Maven will look in DM.DAT for exact and partial matches
  95.      to "file".  If only one match is found, then Directory Maven will
  96.      change to that directory and exit.  If more than one match is
  97.      found, a pop-up list will be displayed showing all matches.  Exact
  98.      matches will be shown at the top of the list followed by partial
  99.      matches.  Cursor to the one you want and press Enter or press Esc
  100.      to cancel.  Up to 999 matches will appear in the list.  Matches on
  101.      inactive drives (e.g. network drives when not logged in) will not
  102.      be shown.
  103.  
  104.      If you want to restrict the search to one specific drive, then
  105.      prefix the directory name with a drive letter and colon:
  106.  
  107.      DM d:partial_directory_name
  108.      DM d:*partial_directory_name
  109.  
  110.      Scanning Drives
  111.      ---------------
  112.      To add new drives or update previously scanned drives in the
  113.      DM.DAT file, use the following commands:
  114.  
  115.      DM /sD
  116.      DM /s+D
  117.  
  118.      where D is the drive list.  For example, DM /sCGK will scan drives
  119.      C, G, and K.  Prefix the drive list with a "+" to include hidden
  120.      directories.  Drives previously scanned, but not scanned this
  121.      time will remain in the scan file unchanged.  You may also scan
  122.      drives in Tree Mode (see below).
  123.      
  124.      Adding New Directories To Scan File
  125.      -----------------------------------
  126.      To add a single directory to the DM.DAT scan file without
  127.      rescanning the entire drive, change to the new directory using the
  128.      DOS CD command and use the Add switch:
  129.  
  130.      DM /a
  131.  
  132.      The parent directory of the new directory must already exist in
  133.      the scan file or the add operation will fail.
  134.  
  135.      Tree Mode Operation
  136.      -------------------
  137.      Run Directory Maven in Tree Mode to see a graphical tree
  138.      representation of your drives.  Start DM without any command line
  139.      parameters to run in Tree Mode.  Your active drives are shown in
  140.      black in the upper left corner of the screen.  Previously scanned
  141.      drives that are currently inactive are shown lower case in gray.
  142.      Examples of inactive drives might include network drives when you
  143.      are logged out of the network, RAM drives and CD-ROM drives when the
  144.      drivers were not loaded during this session, etc.  The 43/50 line
  145.      EGA/VGA modes are supported in Tree Mode.  Use the DOS Mode command
  146.      to set the number of display lines.  Example: MODE CON LINES=50
  147.  
  148.      Directory Tree Navigation
  149.      -------------------------
  150.      The directory tree for the current drive will be displayed on start
  151.      up.  The current directory will be shown in yellow (if previously
  152.      scanned).  Use the cursor keys, PageUp/PageDn, and Home/End keys to
  153.      move through the tree.  Hold the shift key down when using the
  154.      up/down arrow keys to stay in the same tree level.  Press the left
  155.      arrow key to move to the parent of the current directory.  When the
  156.      root directory is highlighted, the date and time the drive was last
  157.      scanned is shown on the bottom status line.  Use the Tab and Shift-Tab
  158.      keys to move to other drives.  Press F1 to display the help screen.
  159.  
  160.      Speed Search
  161.      ------------
  162.      To move quickly to a directory (current drive only) in tree mode,
  163.      begin typing the characters in the name.  The cursor will jump to
  164.      the next match found with each keystroke.  The computer will beep
  165.      if no match is found.  Press Alt-N during Speed Search to look for
  166.      other matches based on the characters you typed in so far.  Press
  167.      Esc or any of the cursor keys to exit Speed Search.  Use the
  168.      backspace key to erase the last Speed Search character.
  169.  
  170.      Scanning Drives
  171.      ---------------
  172.      Press F2 to rescan one or more drives.  If you want to include
  173.      hidden directories, press Shift-F2 instead.  Type in the letters
  174.      representing the drives to scan.  Press Enter to start or Esc to
  175.      cancel.  Only the active drives (shown in black in the upper left
  176.      corner) can be scanned, up to 999 directories each (memory
  177.      permitting).  Drives previously scanned, but not scanned this
  178.      time will remain in the scan file unchanged.  You may also scan
  179.      drives from the DOS command line (see above).
  180.  
  181.      Removing Drives and Directories
  182.      -------------------------------
  183.      To remove a single directory from the scan file, move the cursor
  184.      to the directory and press Delete.  You cannot remove a directory
  185.      if it has subdirectories (unless you remove the subdirectories
  186.      first).  To remove a drive from the scan file (including inactive
  187.      drives), make that drive current using the Tab or Shift-Tab keys,
  188.      and press Shift-Delete.  Note: these commands only remove the
  189.      directories from the DM.DAT scan file, they do not erase files or
  190.      directories from your hard drive.
  191.  
  192.      Printing
  193.      --------
  194.      Press Alt-P to print the directory tree for the current drive.
  195.      The following prompt will appear:
  196.  
  197.      Print tree to LPT (1,2,3):
  198.  
  199.      Press "1" to print to LPT1, "2" for LPT2, etc.  Press Esc to
  200.      cancel printing.  Make sure your printer is set up to print
  201.      extended ASCII characters.  For most HP laser printers, the symbol
  202.      set needed is "PC-8".
  203.  
  204.      Exit Directory Maven
  205.      --------------------
  206.      Press Enter to change to the drive/directory highlighted and exit
  207.      Directory Maven.  Press Esc or Alt-X to exit Directory Maven
  208.      without changing directories.
  209.  
  210.      Misc Information
  211.      ----------------
  212.      Version 1.0 -- 2/18/94: initial release
  213.      Version 1.1 -- 7/26/94: monochrome support (DMCONFIG.EXE)
  214.                              43/50 line EGA/VGA support
  215.                              command line scanning
  216.                              forced drive search
  217.      Version 1.2 -- 7/28/94: 43/50 line bug fix
  218.  
  219.      Directory Maven was written in Borland Pascal 7.0, approximately
  220.      1500 lines of code.
  221.  
  222.      Other Programs by the Author
  223.      ----------------------------
  224.      If you like Directory Maven, please try my shareware product
  225.      File Maven, a DOS file manager that supports copy/move/delete
  226.      file operations including null-modem file transfers.  Look for
  227.      FMAVxx.ZIP on your favorite BBS/Disk Distributor or one of these
  228.      sources:
  229.  
  230.      Compuserve                       ; GO IBMSYS
  231.      The Consultant BBS  718-837-3236 ; ASP Hub, free 1st call download
  232.      Space BBS           415-323-4193 ; ASP Hub, free 1st call download
  233.      Exec-PC             414-789-4210 ; Largest BBS in USA, fee required
  234.      ASP CD-ROM                       ; Software from Association of
  235.                                       ; Shareware Professionals authors
  236.  
  237.      Please send suggestions for improvement to:
  238.  
  239.      Kent Briggs
  240.      109A Romana Circle
  241.      Hewitt, TX  76643
  242.  
  243.      My Compuserve ID is [72124,3234].  Fidonet users can find me in
  244.      the SHAREWRE and PASCAL echoes or send Netmail to me at 1:388/26
  245.      or 1:154/280.
  246.  
  247.